home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fgldrawelements.z / fgldrawelements
Encoding:
Text File  |  2002-10-03  |  8.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss - render primitives from array data
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss( INTEGER*4 _m_o_d_e,
  14.                                  INTEGER*4 _c_o_u_n_t,
  15.                                  INTEGER*4 _t_y_p_e,
  16.                                  CHARACTER*8 _i_n_d_i_c_e_s )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _m_o_d_e     Specifies what kind of primitives to render.  Symbolic constants
  21.               GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  22.               GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP,
  23.               GGGGLLLL____QQQQUUUUAAAADDDDSSSS, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN are accepted.
  24.  
  25.      _c_o_u_n_t    Specifies the number of elements to be rendered.
  26.  
  27.      _t_y_p_e     Specifies the type of the values in _i_n_d_i_c_e_s. Must be one of
  28.               GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT.
  29.  
  30.      _i_n_d_i_c_e_s  Specifies a pointer to the location where the indices are
  31.               stored.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss specifies multiple geometric primitives with very few
  35.      subroutine calls. Instead of calling a GL function to pass each
  36.      individual vertex, normal, texture coordinate, edge flag, or color, you
  37.      can prespecify separate arrays of vertices, normals, and so on and use
  38.      them to construct a sequence of primitives with a single call to
  39.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss.
  40.  
  41.      When ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is called, it uses _c_o_u_n_t sequential elements from an
  42.      enabled array, starting at _i_n_d_i_c_e_s to construct a sequence of geometric
  43.      primitives. _m_o_d_e specifies what kind of primitives are constructed, and
  44.      how the array elements construct these primitives. If more than one array
  45.      is enabled, each is used. If GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY is not enabled, no geometric
  46.      primitives are constructed.
  47.  
  48.      Vertex attributes that are modified by ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss have an
  49.      unspecified value after ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss returns. For example, if
  50.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is enabled, the value of the current color is undefined
  51.      after ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss executes. Attributes that aren't modified maintain
  52.      their previous values.
  53.  
  54. NNNNOOOOTTTTEEEESSSS
  55.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is available only if the GL version is 1.1 or greater.
  56.  
  57.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is included in display lists. If ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is
  58.      entered into a display list, the necessary array data (determined by the
  59.      array pointers and enables) is also entered into the display list.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Because the array pointers and enables are client-side state, their
  75.      values affect display lists when the lists are created, not when the
  76.      lists are executed.
  77.  
  78. EEEERRRRRRRROOOORRRRSSSS
  79.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  80.  
  81.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _c_o_u_n_t is negative.
  82.  
  83.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is executed between
  84.      the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding ffffggggllllEEEEnnnndddd.
  85.  
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss,
  89.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  90.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss, ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr,
  91.      ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.